home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmStringByteCompare.z / XmStringByteCompare
Text File  |  1998-10-30  |  4KB  |  67 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSttttrrrriiiinnnnggggBBBByyyytttteeeeCCCCoooommmmppppaaaarrrreeee((((3333XXXX))))   UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV   XXXXmmmmSSSSttttrrrriiiinnnnggggBBBByyyytttteeeeCCCCoooommmmppppaaaarrrreeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmSSSSttttrrrriiiinnnnggggBBBByyyytttteeeeCCCCoooommmmppppaaaarrrreeee - A compound string function that
  10.           indicates the results of a byte-by-byte comparison
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/Xm.h>
  14.           BBBBoooooooolllleeeeaaaannnn XXXXmmmmSSSSttttrrrriiiinnnnggggBBBByyyytttteeeeCCCCoooommmmppppaaaarrrreeee(
  15.           XXXXmmmmSSSSttttrrrriiiinnnngggg ssss1111,
  16.           XXXXmmmmSSSSttttrrrriiiinnnngggg ssss2222);
  17.  
  18.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  19.           This page documents Motif 2.1.
  20.  
  21.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.           This function is obsolete and exists for compatibility with
  23.           previous releases.  XXXXmmmmSSSSttttrrrriiiinnnnggggBBBByyyytttteeeeCCCCoooommmmppppaaaarrrreeeereturns a Boolean
  24.           indicating the results of a byte-by-byte comparison of two
  25.           compound strings.
  26.  
  27.           In general, if two compound strings are created with the
  28.           same (cccchhhhaaaarrrr ****) string using XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCrrrreeeeaaaatttteeeeLLLLooooccccaaaalllliiiizzzzeeeedddd in the
  29.           same language environment, the compound strings compare as
  30.           equal.  If two compound strings are created with the same
  31.           (cccchhhhaaaarrrr ****) string and the same font list element tag set other
  32.           than XXXXmmmmFFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTAAAAGGGGusing XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCrrrreeeeaaaatttteeee, the strings
  33.           compare as equal.
  34.  
  35.           In some cases, once a compound string is put into a widget,
  36.           that string is converted into an internal form to allow
  37.           faster processing. Part of the conversion process strips out
  38.           unnecessary or redundant information. If an application then
  39.           does an XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss to retrieve a compound string from a
  40.           widget (specifically, Label and all of its subclasses), it
  41.           is not guaranteed that the compound string returned is
  42.           byte-for-byte the same as the string given to the widget
  43.           originally.
  44.  
  45.           _s_1        Specifies a compound string to be compared with _s_2
  46.  
  47.           _s_2        Specifies a compound string to be compared with _s_1
  48.  
  49.      RRRREEEETTTTUUUURRRRNNNN
  50.           Returns True if two compound strings are identical byte-by-
  51.           byte.
  52.  
  53.      RRRREEEELLLLAAAATTTTEEEEDDDD
  54.           XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCrrrreeeeaaaatttteeee(3) and XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCrrrreeeeaaaatttteeeeLLLLooooccccaaaalllliiiizzzzeeeedddd(3).
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.